home *** CD-ROM | disk | FTP | other *** search
/ Aminet 40 / Aminet 40 (2000)(Schatztruhe)[!][Dec 2000].iso / Aminet / dev / c / Emperor.readme < prev    next >
Encoding:
Text File  |  2000-10-24  |  12.5 KB  |  260 lines

  1. Short:    Object-oriented programming language
  2. Author:   Matthias Gietzelt
  3. Uploader: Andreas Gietzelt <endee@t-online.de>
  4. Version:  3.0
  5. Type:     dev/c
  6. Email:    <joachim.gietzelt@klinikum-sn.de>
  7. Requires: OS 3.5, well-equipped Amiga, some knowledge,
  8.  
  9.           Amiga Developer CD 2.1 (see below)
  10.  
  11.  
  12.  
  13.           _______   __   __            ___        _______   ___      ___            ___
  14.          /******/  /**| /**|          /***\      /******/  /***\    /***\          /***\
  15.         /**____/  /***|/***|         /*__**\    /**____/  /*__**\  /*___*\        /*__**\
  16.        /**/      /*/|***/|*|        /*/  |*|   /**/      /*/  |*| /*/   \*\      /*/  |*|
  17.       /**/___   /*/ |**/ |*|       /*/__/**/  /**/___   /*/__/**/ |*|   |*|     /*/__/**/
  18.      /******/  /*/  |_/  |*|      /*******/  /******/  /*******/  |*|   |*|    /*******/
  19.     /**____/  /*/        |*|     /*______/  /**____/  /*__**__/   |*|   |*|   /*__**__/
  20.    /**/      /*/         |*|    /*/        /**/      /*/  \*\     |*|   |*|  /*/  \*\
  21.   /**/___   /*/          |*|   /*/        /**/___   /*/    \*\    \*\___/*/ /*/    \*\
  22.  /******/  /*/           |*|  /*/        /******/  /*/      \*\    \*****/ /*/      \*\
  23. /______/  /_/            |_| /_/        /______/  /_/        \_\    \___/ /_/        \_\
  24.  
  25.  
  26.                             The object-oriented programming language
  27.  
  28.                           Available at www.aminet.de ! (Drawer: dev/c)
  29.  
  30.  
  31.  
  32. Für die deutsche Version, bitte weiter unten lesen....
  33.  
  34.  
  35. ENGLISH:
  36.  
  37.  
  38. History
  39.  
  40. 2.0  - Initial release
  41. ---
  42. 2.1  - GadTools gadgets support !!
  43.      - reached to shrink programsize by coding the window-stuff by myself
  44.        instead of making it by ReActor
  45. ---
  46. 2.2  - Oops..The program crashed, when a clicktab was in a test-window.
  47.      - speed optimizations (e.g. at startup, shutdown etc.)
  48.      - defined catalog-creation
  49.      - C++-Code support
  50.      - added the macro "Preferences-Menu" for Prefs-Programs
  51.      - better & easier generated C-sourcecode
  52.      - minor bugfixes
  53. ---
  54. 2.3  - prefs-editor rewritten
  55.      - chooseable processortype for generated StormC-project
  56.      - modified programming-help
  57.      - some functionmacros rewritten
  58.      - minor bugfixes
  59. ---
  60. 3.0  - gadgets-test routine rewritten
  61.      - fixed bugs by showing tapedeck & colorwheel gadgets
  62.      - fixed problems with clicktabs & page gadgets (see "clicktabsexample")
  63.      - added function "Shutdown()" (called, when program quits)
  64.      - added progress-bar while saving
  65.      - added macrofunctions "Emperor_Set/GetGadgetAttrComplex()"
  66.        (see guide for details)
  67.  
  68.  
  69. Introduction
  70.  
  71. Thanks for decrunching and the will to testing the program-packet.
  72. This program is for "revolutioning" the software-development on Amiga.
  73.  
  74. Object-oriented programminglanguage (OOP) is maybe a bit too high for that
  75. program, because there are "real" C/C++-sourcecodes generated and
  76. an external C/C++-Compiler must translate it into machine-code. In the Amiga-sphere
  77. there are only less applications like CanDo, Storm-Wizard and so on, but one day
  78. I have sawn the program "Delphi" on the PC :( ! This OOP is exclusive controlable
  79. in Pascal (that set's me up) and it has millions of configuration-possibilities.
  80. I didn't knew such things on Amiga, and so I made it by myself.
  81.  
  82. I want to make parameting of the Graphical User Interface (GUI) and its macro-elements as easy as
  83. possible. Following standard-GUI-elements are implemented:
  84.  * Windows
  85.  * OS2.0 Gadgets (GadTools)
  86.  * OS3.5 Gadgets (Reaction)
  87.  * Requests      (EasyRequest)
  88.  * Menus         (NewMenu)
  89.  * ASL-Requests  (File, Font, Screenmode)
  90.  * Locale        (Translations)
  91.  * Function-macros, which makes programming under OS3.5 more easily
  92.  
  93. With Emperor you are generating a complete C/C++-sourcecode, which only must be
  94. compiled by an external compiler (e.g. StormC from the developer CD2.1).
  95.  
  96. Aim of this program is to assure software developer to create their programs (its sourcecode)
  97. by Emperor, because the making of software (opening of windows, file- and fontrequests,
  98. menus etc.) is often equal and is no longer copied by programmers from other sourcecodes.
  99. Emperor decrees about one or more macros for every GUI-element. Like the menus:
  100. here you must, for creating the complete Project-menu (open, close, save, print etc.) and its
  101. translation, (in Locale-".catalog"-file) only select the corresponding entry in the list.
  102. This is also possible at requests e.g. by making a QuitRequest. These are called in
  103. the own sourcecode as function "REQUESTNAME();".
  104.  
  105. But the programm should also be for user, who never programmed before,
  106. and bade an easy way in the programming of AmigaOS-GUIs.
  107.  
  108.  
  109. Systemrequirements
  110.  
  111.   - an Amiga ;-)
  112.   - Memory at least 24 MByte !!; recommended 64 MByte or more
  113.   - Workbench version 3.5 or higher
  114.   - Processor at least 68020; recommended 68060
  115.   - Amiga Developer CD 2.1 of the HAAGE & Partner GmbH
  116.   - C/C++-Compiler (from the developer CD "ADCD_2.1:Contributions/Haage_&_Partner/StormC/")
  117.   - CatComp (from the developer CD "ADCD_2.1:NDK/NDK_3.5/Tools/CatComp")
  118.   - xen.font in size 8 installed in "Fonts:"-directory of the Bootdevice, :-)
  119.  
  120.  
  121. DEUTSCH:
  122.  
  123.  
  124. Die Geschichte
  125.  
  126. 2.0  - Erste Veröffentlichung
  127. ---
  128. 2.1  - AmigaOS 2.0 Gadgets hinzugefügt !!
  129.        (GadTools-Gadgets sind nun verfügbar !)
  130.      - Programm ist durch Code-Umsetzung von ReActor nach eigenem Code geschrumpft.
  131. ---
  132. 2.2  - Programmabsturz, wenn Clicktab-Gadgets in einem Test-Fenster waren.
  133.      - Geschwindigkeitsoptimierungen (z.B. beim Start, Ende etc.)
  134.      - definierte Catalog-Erstellung
  135.      - Makro "Preferences-Menü" für Einstellungs-Programme
  136.      - C++-Quelltext Unterstützung
  137.      - besserer & einfacherer generierter C-Quelltext
  138.      - minimale Fehler behoben
  139. ---
  140. 2.3  - Prefs-Editor überarbeitet
  141.      - wählbarer Prozessortyp für generierten StormC-Projekt
  142.      - modifizierte Programmierhilfe
  143.      - diverse Funktionsmakros überarbeitet
  144.      - minimale Fehler behoben
  145. ---
  146. 3.0  - Gadget-Test Routine überarbeitet
  147.      - Fehler beim Anzeigen von Tapedeck & Colorwheel Gadgets behoben
  148.      - Probleme mit Clicktabs & Page Gadgets behoben (siehe "clicktabsexample")
  149.      - Funktion "Shutdown()" hinzugefügt (Aufruf, bei Programmende)
  150.      - Fortschrittsanzeige während des Speicherns
  151.      - Makrofunktion "Emperor_Set/GetGadgetAttrComplex()" hinzugefügt
  152.        (siehe Emperor.guide)
  153.  
  154.  
  155. Die Einführung
  156.  
  157. Vielen Dank, daß Sie dieses Programm entpackt haben und ausprobieren möchten !
  158. Dieses Programm soll die Software-Entwicklung auf dem Amiga "revolutionieren".
  159.  
  160. Objekt-orientierte Programmiersprache (OOP) ist vielleicht ein wenig
  161. zu hoch gegriffen, da weiterhin "echte" C/C++-Quelltexte generiert und
  162. durch einen externen C/C++-Compiler übersetzt werden müssen. Im Amiga-Bereich
  163. gibt's nur wenige Ausnahmen wie CanDo, Storm-Wizard u.a., aber irgendwann habe
  164. ich das Programm "Delphi" auf dem PC :( kennengelernt ! Diese OOP ist
  165. ausschließlich in Pascal gehalten (was mich arg störte) und erschlägt einen
  166. mit den Millionen Konfigurations-möglichkeiten. Ich kannte soetwas in der Art
  167. bisher auf dem Amiga nicht, und kurzentschlossen setzte ich mich selbst daran.
  168.  
  169. Ich wollte die Parametrierung der Oberfläche und der Makro-Elemente so einfach wie
  170. möglich machen. Folgende Standard-Oberflächenelemente sind implementiert:
  171.  * Fenster
  172.  * OS2.0 Gadgets (GadTools)
  173.  * OS3.5 Gadgets (Reaction)
  174.  * Requester     (EasyRequest)
  175.  * Menüs         (NewMenu)
  176.  * ASL-Requester (File, Font, Screenmode)
  177.  * Locale        (Übersetzungen)
  178.  * vorgefertigte Funktionsmakros, die das Programmieren unter OS3.5 wesentlich erleichtern.
  179.  
  180. Man generiert mit Emperor einen komplett fertigen C/C++-Quelltext, der nur noch
  181. durch einen externen Compiler (z.B. StormC auf der Developer CD2.1) übersetzt werden muß.
  182.  
  183. Ziel dieses Programms soll sein, Softwareentwickler zu überzeugen mit Emperor ihre
  184. Programme (deren Quelltext) zu erstellen, da die Verfahrensweise bei der Erstellung
  185. von Software (Öffnen von Fenstern, Datei- und Schriftauswahlrequestern, Menüs etc.)
  186. oft gleich ist und nicht weiter durch den Programmierer selbst mühsam aus anderen
  187. Quelltexten herausgefischt werden muß. Emperor verfügt für jedes Element schon
  188. ein oder mehrere vorgefertigte, aber veränderbare, Makros. So z.B. bei den Menüs:
  189. hier muß für das Projekt-Menü (Öffnen, Speichern, Drucken etc.) und dessen
  190. Übersetzung (für Locale - ".catalog"-Datei) nur der entsprechende Eintrag
  191. gewählt werden. Dies gilt auch für Requester z.B. für das QuitRequest. Diese müssen
  192. nur noch im eigenen Quelltext als Funktion "REQUESTERNAME();" aufgerufen werden.
  193.  
  194. Das Programm soll aber auch für Amigianer sein, die noch nie programmiert haben,
  195. und so einen einfachen Einstieg in die Programmierung der AmigaOS-Oberfläche bieten.
  196.  
  197.  
  198. Die Systemanforderungen
  199.  
  200.   - einen Amiga ;-)
  201.   - Speicher mindestens 24 MByte !!; empfohlen 64 MByte oder mehr
  202.   - Workbench Version 3.5 oder höher
  203.   - Prozessor mindestens 68020; empfohlen 68060
  204.   - Amiga Developer CD 2.1 von der HAAGE & Partner GmbH
  205.   - C/C++-Compiler (von der Developer CD "ADCD_2.1:Contributions/Haage_&_Partner/StormC/")
  206.   - CatComp (von der Developer CD "ADCD_2.1:NDK/NDK_3.5/Tools/CatComp")
  207.   - xen.font in der Größe 8 im "Fonts:"-Verzeichnis des Bootlaufwerks, :-)
  208.  
  209.  
  210. ============================= Archive contents =============================
  211.  
  212. Original  Packed Ratio    Date     Time    Name
  213. -------- ------- ----- --------- --------  -------------
  214.    26412    7375 72.0% 21-Oct-00 16:24:02  Emperor/Catalogs/deutsch/Emperor.catalog
  215.    34846    7469 78.5% 21-Oct-00 16:23:56  Emperor/Catalogs/Emperor.cd
  216.    40992   15696 61.7% 21-Oct-00 19:14:36  Emperor/Projects/AminetSearcher
  217.     1428     842 41.0% 21-Oct-00 19:14:36  Emperor/Projects/AminetSearcher.info
  218.     1686     826 51.0% 21-Oct-00 19:14:36  Emperor/Projects/Catalogs/deutsch/AminetSearcher.catalog
  219.      606     342 43.5% 21-Oct-00 19:14:36  Emperor/Projects/Catalogs/deutsch/ClicktabExample.catalog
  220.     1006     552 45.1% 21-Oct-00 19:14:36  Emperor/Projects/Catalogs/deutsch/DevsManager.catalog
  221.     1074     718 33.1% 21-Oct-00 19:14:36  Emperor/Projects/ClicktabExample.info
  222.     1593     889 44.1% 21-Oct-00 19:14:36  Emperor/Projects/DevsManager.info
  223.   143466   12513 91.2% 21-Oct-00 19:14:36  Emperor/Projects/AminetSearcher.c
  224.     2578     856 66.7% 21-Oct-00 19:14:36  Emperor/Projects/AminetSearcher.cd
  225.    21440    2953 86.2% 21-Oct-00 19:14:36  Emperor/Projects/AminetSearcher.h
  226.    11057    2133 80.7% 21-Oct-00 19:14:36  Emperor/Projects/AminetSearcher.project
  227.     1160     491 57.6% 21-Oct-00 19:14:36  Emperor/Projects/AminetSearcher.¶
  228.     3596    1328 63.0% 21-Oct-00 19:14:36  Emperor/Projects/AminetSearcher_deutsch.ct
  229.     3585     968 72.9% 21-Oct-00 19:14:36  Emperor/Projects/AminetSearcher_lowlevel.h
  230.    20356    8524 58.1% 21-Oct-00 19:14:36  Emperor/Projects/ClicktabExample
  231.    83964    8616 89.7% 21-Oct-00 19:14:36  Emperor/Projects/ClicktabExample.c
  232.       69      69  0.0% 21-Oct-00 19:14:36  Emperor/Projects/ClicktabExample.h
  233.     1558     840 46.0% 15-Oct-00 17:57:06  Emperor/Projects.info
  234.     2225     416 81.3% 21-Oct-00 19:14:36  Emperor/Projects/ClicktabExample.project
  235.      913     409 55.2% 21-Oct-00 19:14:36  Emperor/Projects/ClicktabExample.README!
  236.     1163     492 57.6% 21-Oct-00 19:14:36  Emperor/Projects/ClicktabExample.¶
  237.    28536   11790 58.6% 21-Oct-00 19:14:36  Emperor/Projects/DevsManager
  238.    93504   10082 89.2% 21-Oct-00 19:14:38  Emperor/Projects/DevsManager.c
  239.     1602     585 63.4% 21-Oct-00 19:14:38  Emperor/Projects/DevsManager.cd
  240.     7903    1410 82.1% 21-Oct-00 19:14:38  Emperor/Projects/DevsManager.h
  241.     4936    1075 78.2% 21-Oct-00 19:14:38  Emperor/Projects/DevsManager.project
  242.     1151     489 57.5% 21-Oct-00 19:14:38  Emperor/Projects/DevsManager.¶
  243.     2231     899 59.7% 21-Oct-00 19:14:38  Emperor/Projects/DevsManager_deutsch.ct
  244.     1643    1167 28.9% 15-Oct-00 17:57:08  Emperor.info
  245.    11023    2953 73.2% 21-Oct-00 16:23:12  Emperor.install
  246.     1245     979 21.3% 21-Oct-00 16:23:12  Emperor.install.info
  247.      913     409 55.2% 18-Oct-00 10:51:36  Emperor/ClicktabExample.README!
  248.   811040  213060 73.7% 21-Oct-00 19:13:46  Emperor/Emperor
  249.     2692    1456 45.9% 21-Oct-00 19:13:46  Emperor/Emperor.info
  250.       68      58 14.7% 16-Oct-00 15:27:28  Emperor/Emperor.prefs
  251.     1892    1031 45.5% 16-Oct-00 15:27:30  Emperor/Emperor.prefs.info
  252.     9189    3849 58.1% 21-Oct-00 16:49:00  Emperor/Emperor.readme
  253.     1497    1039 30.5% 21-Oct-00 16:49:00  Emperor/Emperor.readme.info
  254.    72056   18791 73.9% 21-Oct-00 16:49:00  Emperor/Emperor_deutsch.guide
  255.     1497    1039 30.5% 21-Oct-00 16:49:00  Emperor/Emperor_deutsch.guide.info
  256.    62222   15159 75.6% 21-Oct-00 16:49:00  Emperor/Emperor_english.guide
  257.     1497    1036 30.7% 21-Oct-00 16:49:00  Emperor/Emperor_english.guide.info
  258. -------- ------- ----- --------- --------
  259.  1525110  363673 76.1% 21-Oct-100 19:16:58   44 files
  260.